home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / dog316.zip / DOG.DOC < prev    next >
Text File  |  1992-03-30  |  42KB  |  1,143 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          Disk OrGanizer - Version 3.16
  19.                                 March 27, 1992
  20.  
  21.                               Soft GAM's Software
  22.                               G. Allen Morris III
  23.                                  P. O. Box 1311
  24.                               Mendocino, CA  95460
  25.  
  26.                                  Copyright 1991
  27.                               All Rights Reserved
  28.  
  29.                             Compuserve: #73210,3374
  30.                         BBS: (707)778-8944, ALLEN MORRIS
  31.                               Voice: (707)961-1632
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                               _______
  39.                          ____|__     |               (tm)
  40.                       --|       |    |-------------------
  41.                         |   ____|__  |  Association of
  42.                         |  |       |_|  Shareware
  43.                         |__|   o   |    Professionals
  44.                       -----|   |   |---------------------
  45.                            |___|___|    MEMBER
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                Table of Contents
  52.  
  53.  
  54.  
  55.  
  56.         1. Getting started ........................................... 1
  57.         1.1. Introduction ............................................ 1
  58.         1.2. Shareware ............................................... 1
  59.         1.3. Purpose ................................................. 1
  60.         1.4. Installation ............................................ 1
  61.         1.5. Background programs ..................................... 2
  62.         1.6. Copy protected programs ................................. 3
  63.         1.7. Power failure ........................................... 3
  64.         1.8. Quick start ............................................. 3
  65.  
  66.         2. Using Disk OrGanizer ...................................... 5
  67.         2.1. Modes ................................................... 5
  68.         2.2. Switches ................................................ 6
  69.         2.3. Command line syntax ..................................... 6
  70.         2.3.1. Command line commands ................................. 7
  71.         2.4. Orderfile syntax ........................................ 7
  72.         2.4.1. Setting the mode ...................................... 7
  73.         2.4.2. Setting switches ...................................... 8
  74.         2.4.3. Order file Commands ................................... 8
  75.         2.4.4. File identifiers ..................................... 10
  76.         2.4.5. Comments ............................................. 10
  77.  
  78.         3. Licensing and support .................................... 11
  79.         3.1. Copyright/License/Warranty ............................. 11
  80.         3.2. Licensing .............................................. 11
  81.         3.3. Technical Support ...................................... 12
  82.         3.4. ASP Ombudsman Information .............................. 12
  83.  
  84.         4. Error messages ........................................... 13
  85.  
  86.         5. Glossary ................................................. 16
  87.  
  88.         6. Index .................................................... 17
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                       i
  105.  
  106.      1. Getting started
  107.      ----------------------------------------------------------------------
  108.      1.1. Introduction
  109.  
  110.  
  111.         1.1. Introduction
  112.  
  113.         Hello,  and thank you for taking the time to read this manual. I
  114.         hope that you find Disk OrGanizer useful.
  115.  
  116.         1.2. Shareware
  117.  
  118.         Disk OrGanizer is not a public domain program. There is  no  fee
  119.         for personal use of Disk OrGanizer.
  120.  
  121.         You may register your copy of Disk OrGanizer for $30 and receive
  122.         a disk and manual along with notification of major upgrades.
  123.  
  124.         A license is required for use of Disk OrGanizer by  corporations
  125.         and institutions, and for its commercial distribution.
  126.  
  127.         If you don't support shareware, who will?
  128.  
  129.         1.3. Purpose
  130.  
  131.         A  disk  that has been in use a while will usually become slower
  132.         accessing the data and programs that have  been  stored  on  it.
  133.         This is due to two problems:
  134.  
  135.          o  The disk has become fragmented.
  136.          o  There are deleted entries in directories.
  137.  
  138.         Disk  OrGanizer will solve these problems and make your disk run
  139.         like new.
  140.  
  141.         If the size of a directory decreases enough after  removing  the
  142.         deleted  entries,  Disk  OrGanizer  can  also  recover some disk
  143.         space.
  144.  
  145.         Disk OrGanizer has been tested with  MS-DOS  2.10,  3.01,  3.10,
  146.         3.30,  4.01 and 5.0 on logical drives as large as 600 megabytes.
  147.         It is believed that Disk OrGanizer will operate on any MS/PC-DOS
  148.         disk.
  149.  
  150.         Disk OrGanizer performs extensive tests before it starts to move
  151.         data, to make sure that the  File  Allocation  Table  (FAT)  and
  152.         directories are in good repair.
  153.  
  154.         1.4. Installation
  155.  
  156.         You should BACK UP your hard disk before you run Disk OrGanizer.
  157.  
  158.         To  install Disk OrGanizer, you need only copy it to a directory
  159.         on your PATH.
  160.  
  161.         You can test Disk OrGanizer by typing the command:
  162.  
  163.  
  164.  
  165.      Disk OrGanizer                                                       1
  166.  
  167.      1. Getting started
  168.      ----------------------------------------------------------------------
  169.      1.4. Installation
  170.  
  171.  
  172.              DOG [d:] /TEST
  173.  
  174.         d: is an optional drive specifier. (The []'s mean  optional  and
  175.         should  not  be  typed.)  If  no drive is specified, the current
  176.         drive will be used.
  177.  
  178.         If Disk OrGanizer reports errors  and  you  have  not  run  Disk
  179.         OrGanizer  before,  you should run CHKDSK with the /F switch and
  180.         repair the disk.
  181.  
  182.         If you have not backed up your disk, Disk  OrGanizer  will  warn
  183.         you as to how many files may need to be backed up.
  184.  
  185.         PLEASE back up your disks before you run Disk OrGanizer.
  186.  
  187.         Disk  OrGanizer will also list any files that are open on on the
  188.         disk that you are organizing. Disk OrGanizer will not be able to
  189.         move these files nor pack the directories that they are in.
  190.  
  191.         If you have used other disk defragment programs before, and have
  192.         had no problem, it should be safe to run Disk OrGanizer.
  193.  
  194.         Disk OrGanizer will move HIDDEN files,  most other disk  defrag-
  195.         menters don't move these files.
  196.  
  197.         If  you  have  not  run any disk defragment programs before, you
  198.         should read the rest of this chapter.
  199.  
  200.         1.5. Background programs
  201.  
  202.         Disk OrGanizer reads and writes to the disk directly. If a  pro-
  203.         gram  tries  to  write  to  the  disk  while  Disk  OrGanizer is
  204.         operating, data may be lost. You should not run  Disk  OrGanizer
  205.         on  a  disk  that you know will be written to. Programs that are
  206.         likely to write to the disk are printer  spoolers,  multitasking
  207.         programs  like  Windows or DesqView, switching programs and net-
  208.         work programs.
  209.  
  210.         If you have FASTOPEN installed on your computer, you  will  need
  211.         to reboot your computer after you run Disk OrGanizer.
  212.  
  213.         Some  background programs leave files open all of the time. Disk
  214.         OrGanizer will not move files that are open,  and  it  will  not
  215.         pack a directory that has open files in it.
  216.  
  217.         If  you do not know if you have these programs on your computer,
  218.         I would suggest that you run Disk OrGanizer from a  floppy  disk
  219.         as described in the Quick Start section.
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.      Disk OrGanizer                                                       2
  227.  
  228.      1. Getting started
  229.      ----------------------------------------------------------------------
  230.      1.6. Copy protected programs
  231.  
  232.  
  233.         1.6. Copy protected programs
  234.  
  235.         Disk OrGanizer may make some copy protected software unusable.
  236.  
  237.         It  is  recommended  that you remove any copy protected software
  238.         from your disk before you  run  Disk  OrGanizer,  if  you  can't
  239.         determine its compatibility with Disk OrGanizer.
  240.  
  241.         1.7. Power failure
  242.  
  243.         Disk OrGanizer can recover from a power failure or reboot.
  244.  
  245.         If  a  power  failure  or  inadvertent  reboot occurs while Disk
  246.         OrGanizer is running, you should run  Disk  OrGanizer  again  as
  247.         soon  as possible. Disk OrGanizer will report any errors that it
  248.         finds on the disk and ask you if you would like to repair  them.
  249.         If  you  answer yes to all of the questions, Disk OrGanizer will
  250.         repair the disk and then continue operation as normal.
  251.  
  252.         You should not use any third party  CHKDSK  type  programs  that
  253.         recover  lost  clusters.  If you use CHKDSK, you should NOT make
  254.         the lost cluster chains into files.
  255.  
  256.         1.8. Quick start
  257.  
  258.         If you would like to defragment your disk and get back  to  work
  259.         without having to read the rest of this manual, the simplest and
  260.         safest way to run Disk OrGanizer is described here.
  261.  
  262.         The first thing to do is to find an old or unused  floppy  disk.
  263.         Then format this disk with a copy of the system.
  264.  
  265.              FORMAT A: /sys
  266.  
  267.         Copy DOG.EXE to the floppy disk.
  268.  
  269.              COPY DOG.EXE A:
  270.  
  271.         You may need to create or copy CONFIG.SYS on the new disk if you
  272.         have disk drivers or an EMS  memory  driver  that  needs  to  be
  273.         installed.
  274.  
  275.         Reboot  your  computer  (Ctrl-Alt-Delete)  with the new disk in-
  276.         stalled in the A: drive.
  277.  
  278.         DOS will ask you for the date and time. This is because there is
  279.         no AUTOEXEC.BAT file.  Enter the correct date and time.
  280.  
  281.         Run Disk OrGanizer on your hard disk.
  282.  
  283.              DOG C: /AUTO /CRC /TRUNCATE
  284.  
  285.  
  286.  
  287.      Disk OrGanizer                                                       3
  288.  
  289.      1. Getting started
  290.      ----------------------------------------------------------------------
  291.      1.8. Quick start
  292.  
  293.  
  294.  
  295.         Disk  OrGanizer  will  test  the  disk (like CHKDSK), give you a
  296.         report, analyze the disk to determine the best place to have the
  297.         directories and files on the disk. Tell you how many directories
  298.         need to have deleted files removed (packed), tell you  how  many
  299.         directories  can  be  made shorter (truncated), and tell you the
  300.         number of clusters that it will have to move to  defragment  the
  301.         files and directories on the disk.
  302.  
  303.         You  will then be asked if it is OK to write to the disk. If you
  304.         answer no to this question, Disk  OrGanizer  will  quit  without
  305.         ever  having  written  to  the  disk.  If  you  answer yes, Disk
  306.         OrGanizer will pack the directories, truncate  the  directories,
  307.         and then start moving clusters.
  308.  
  309.         While  Disk  OrGanizer is moving clusters, you will see the fol-
  310.         lowing message:
  311.  
  312.              X nnnnn - elapsed time  0:00:00  estimated 0:00:00
  313.  
  314.         X  is  either  R)eading,  S)orting,  C)omputing  CRC,  W)riting,
  315.         T)esting  CRC,  L)inking  new  clusters  or  U)pdating  FAT  and
  316.         directories. nnnnn is the number  of  clusters  that  have  been
  317.         moved.  Elapsed  time  is  the amount of time Disk OrGanizer has
  318.         been moving clusters, and estimated is the approximate amount of
  319.         time it will take to organize the disk.
  320.  
  321.         You  can quit from Disk OrGanizer at anytime by pressing the es-
  322.         cape (Esc) key or a ^C. Stopping  Disk  OrGanizer  while  it  is
  323.         moving  clusters  may  cause  extreme fragmentation.  Rerun Disk
  324.         OrGanizer as soon as possible, if you abort while it  is  moving
  325.         clusters.
  326.  
  327.         If  you think that Disk OrGanizer has stopped running, press the
  328.         space bar.  You should then hear a beep within a few seconds.
  329.  
  330.         When it is done it will check the disk once again,  give  you  a
  331.         new report and then exit.
  332.  
  333.         You  should  then  remove the floppy disk from the A: drive, and
  334.         reboot your computer.
  335.  
  336.         You should notice that the programs on your disk load  a  little
  337.         faster.  If  Disk  OrGanizer truncated some directories you will
  338.         also have more free disk space.
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.      Disk OrGanizer                                                       4
  349.  
  350.      2. Using Disk OrGanizer
  351.      ----------------------------------------------------------------------
  352.  
  353.  
  354.         The purpose of Disk OrGanizer is to speed up the access of files
  355.         on your disks.  There are two things that slow  down  access  of
  356.         data:  deleted  files  in directories, and fragmented files. The
  357.         actual placement of files on a disk has very little to  do  with
  358.         the  amount  of time it takes to load a file.  Most disk defrag-
  359.         ment programs take a long time to run,  and  this  keeps  people
  360.         from running them often.
  361.  
  362.         Disk  OrGanizer  has complex algorithms that allow it to defrag-
  363.         ment all of the files on a disk while moving very few  clusters.
  364.         Although  Disk  OrGanizer can control the placement of files and
  365.         directories on the disk, I would suggest that you  refrain  from
  366.         using  this  feature,  as  it can greatly increase the number of
  367.         clusters that Disk OrGanizer will need to move and give you very
  368.         little  benefit.  The exception to this are directories that are
  369.         read often, such as the directories on the PATH, which  you  may
  370.         want  to  move  near  the  File  Allocation  Table (see the AUTO
  371.         command.)
  372.  
  373.         2.1. Modes
  374.  
  375.         The mode determines how Disk OrGanizer will organize a disk.
  376.  
  377.         FILL - mode will defragment files and put them as close  to  the
  378.              FAT as possible, FILL will not leave any free space between
  379.              files. FILL may leave  files  fragmented  around  BAD  disk
  380.              sectors and unmovable files. This mode gives you all of the
  381.              benefits of that you get from other disk defragmenter,  but
  382.              only takes a fraction of the time to run.
  383.  
  384.         FAST - mode will defragment all files and attempt to put them in
  385.              one area of disk space. FAST may leave gaps of  free  space
  386.              between files.
  387.  
  388.         QUICK - mode is like FAST mode but does not try as hard.
  389.  
  390.         DEFRAG -  mode  will  defragment  the files on the drive without
  391.              concern for their placement.
  392.  
  393.         The following modes will more than likely cause all of the files
  394.         and sub-directories on a disk to be moved.
  395.  
  396.         DATE -  mode  will  put the files on the disk oldest files first
  397.              (closest to the FAT). Using this mode once in a  while,  it
  398.              can  take  a  long  time to run, may decrease the number of
  399.              clusters that Disk OrGanizer will need  to  move  with  the
  400.              FAST or FILL mode.
  401.  
  402.         DIRECTORY -  mode will put the files on the disk in the order in
  403.              finds them in the directories. That is, the first  file  or
  404.              sub-directory  in the root directory will be closest to the
  405.              FAT (also refered to as LOW), followed by the  second  file
  406.  
  407.  
  408.  
  409.      Disk OrGanizer                                                       5
  410.  
  411.      2. Using Disk OrGanizer
  412.      ----------------------------------------------------------------------
  413.      2.1. Modes
  414.  
  415.  
  416.              in the root, etc.
  417.  
  418.         The  following  modes  are  for compatibility to older versions.
  419.         They are of little use.
  420.  
  421.         FRAGMENTED - This will put all of the files that are  not  frag-
  422.              mented  on the disk first, and will then put the fragmented
  423.              files on the disk. Using this function will slowly put  all
  424.              of  the files that change size away from the FAT. This mode
  425.              does not work well if you have BAD clusters or system files
  426.              other than DOS on the disk.
  427.  
  428.         PACKED -  This  leaves  the  files in the same order as it finds
  429.              them on the disk, by cluster.
  430.  
  431.         2.2. Switches
  432.  
  433.         CRC - will cause Disk OrGanizer to read data after it is written
  434.              to  the  disk,  and  test  to make sure that it was written
  435.              correctly.
  436.  
  437.         BATCH - tells Disk OrGanizer to suppress all  prompts.  This  is
  438.              useful  for  running  Disk  OrGanizer from a batch file. If
  439.              this switch is set, any error will cause Disk OrGanizer  to
  440.              terminate.
  441.  
  442.         NOVERIFY -  tells  DOS  not  to verify data written to the disk.
  443.              (see VERIFY in your DOS  manual)  This  will  increase  the
  444.              speed  of  Disk  OrGanizer, but will allow data to be lost.
  445.              This switch should not be used on a floppy disk, but may be
  446.              used on a hard disk at your own risk. This is for people to
  447.              whom speed is more important than data  integrity.  If  you
  448.              have  set  the  CRC switch, then Disk Organizer will verify
  449.              the data, and  you  can  include  this  switch  to  improve
  450.              performance.
  451.  
  452.         2.3. Command line syntax
  453.  
  454.         The  Command  line  syntax  to  run  Disk OrGanizer from the DOS
  455.         prompt is:
  456.  
  457.              DOG [d:] [orderfile] [/commands] [/mode] [/switches]
  458.  
  459.         (The []'s mean optional and should not be typed.)
  460.  
  461.         d: is an optional drive specifier. If no drive is specified  the
  462.         current drive will be organized.
  463.  
  464.         Orderfile is the path and filename of the order file. If this is
  465.         not included,  Disk  OrGanizer  will  look  for  a  file  called
  466.         ORDER.DOG  in  the  root directory of the drive being organized,
  467.         and if it does not find that, it will look  in  the  environment
  468.  
  469.  
  470.      Disk OrGanizer                                                       6
  471.  
  472.      2. Using Disk OrGanizer
  473.      ----------------------------------------------------------------------
  474.      2.3. Command line syntax
  475.  
  476.  
  477.         for  DOG=d:\path\filename and use that file.  If no orderfile is
  478.         found, the DOS NUL device is used.  If you have an orderfile and
  479.         don't wish to use it, you can tell Disk OrGanizer to use the NUL
  480.         file as an orderfile (ie. DOG NUL /AUTO).
  481.  
  482.         Commands consist of AUTO and TRUNCATE.
  483.  
  484.         Mode tells Disk OrGanizer where to place the files on the drive.
  485.         You  must  supply  a  mode  to  suppress  the  shareware sign-on
  486.         message. The mode can be set  on  the  command  line  or  in  an
  487.         orderfile.
  488.  
  489.         Switches  allow  you  to  control several options as to how Disk
  490.         OrGanizer will test the data that is moved,  and  interact  with
  491.         the  operator.  Switches can be set on the command line or in an
  492.         orderfile.
  493.  
  494.         2.3.1. Command line commands
  495.  
  496.         TRUNCATE - tells Disk OrGanizer to truncate all sub-directories.
  497.  
  498.         AUTO - tells Disk OrGanizer to put the  directories  defined  in
  499.              the  PATH  environment variable first, followed by the file
  500.              definded by the COMSPEC environment variable, and then  all
  501.              of  the  other  directories.  If  no  other  mode  has been
  502.              specified, it will then order the rest of the files  as  if
  503.              the /FILL mode was set.
  504.  
  505.         2.4. Orderfile syntax
  506.  
  507.         The orderfile can be used as a simple configuration file, or can
  508.         be used to tell DOG the exact order that you would like to  have
  509.         your files on a disk.
  510.  
  511.         Modes  and  switches  that  are  given  on the command line will
  512.         override those in the orderfile.
  513.  
  514.         You may find it more convenient to run  Disk  OrGanizer  from  a
  515.         batch  file  than  to  use the orderfile feature.  Again I would
  516.         like to point out that the placement of files has little  effect
  517.         on the speed at which they can be read.
  518.  
  519.         If  you  use  the  AUTO command line command, you may not end up
  520.         with what you expected. (See listing 2.1)
  521.  
  522.         2.4.1. Setting the mode
  523.  
  524.         To give a mode in the order file, enclose it in square  brackets
  525.         ([]).  A  mode must be given on the command line or in the order
  526.         file for Disk OrGanizer to run. For a description of  the  modes
  527.         see  above.  A  mode given on the command line will override the
  528.         mode in the ORDER file.
  529.  
  530.  
  531.      Disk OrGanizer                                                       7
  532.  
  533.      2. Using Disk OrGanizer
  534.      ----------------------------------------------------------------------
  535.      2.4.2. Setting switches
  536.  
  537.  
  538.         ________________________________________________________________
  539.                    Listing 2-1: A very simple ORDER.DOG file
  540.  
  541.               ; The []s must be included.
  542.               [FILL]          ; set the mode
  543.               ;  Truncate all of the directories
  544.               [TRUNCATE ALL]  ; Directories that have already been
  545.                               ; specified, will not be truncated.
  546.               ; The AUTO command line command appends
  547.               [PATH]          ; these three orderfile commands
  548.               [COMSPEC]       ; to the end of the orderfile.
  549.               [ALLDIR]        ;
  550.               ;
  551.  
  552.         ________________________________________________________________
  553.  
  554.         2.4.2. Setting switches
  555.  
  556.         Switches can be specified in the orderfile by enclosing them  in
  557.         square brackets ([]). (See the section on switches above.)
  558.  
  559.         2.4.3. Order file Commands
  560.  
  561.         The area of the disk close to the FAT is called the LOW area and
  562.         the area away from the FAT is called the HIGH area.    Any  file
  563.         that  is  not  named  anywhere  in the ORDER.DOG file is said to
  564.         FLOAT.
  565.  
  566.         In making this file you should name as few files as possible.
  567.  
  568.         The following three  commands  are  a  shorthand  for  file  and
  569.         directory names.
  570.  
  571.         PATH - is the same as listing all of the directories in the PATH
  572.              environment variable that are on the drive being organized.
  573.  
  574.         COMSPEC - The filename given in the COMSPEC environment variable
  575.              is used if it points to the drive being organized.
  576.  
  577.         ALLDIRECTORIES -  Is  the same as listing all of the directories
  578.              on the drive.
  579.  
  580.         The following commands tell where to place named files.
  581.  
  582.         LOW - tells Disk OrGanizer to place the files described by  fol-
  583.              lowing  filenames  close to the FAT.  This also affects the
  584.              FREE command. (see below)
  585.  
  586.         HIGH - tells Disk OrGanizer to place files described by  follow-
  587.              ing  filenames  away  from  the FAT.  This also affects the
  588.  
  589.  
  590.  
  591.  
  592.      Disk OrGanizer                                                       8
  593.  
  594.      2. Using Disk OrGanizer
  595.      ----------------------------------------------------------------------
  596.      2.4.3. Order file Commands
  597.  
  598.  
  599.         ________________________________________________________________
  600.                        Listing 2-2: Sample ORDER.DOG file
  601.  
  602.            ;
  603.            [DEFRAGMENT]    ; if no mode is given on the command
  604.                            ; line use DEFRAGMENT
  605.            [FORCE]         ;
  606.            \COPYPRO.SYS    ; I don't want this file to move
  607.            [FLOAT]
  608.            [TRUNCATE]      ;
  609.            \DIR_A\         ; Truncate sub-directory DIR_A, but let
  610.                            ; it FLOAT.
  611.            ;
  612.            [LOW]           ; Set move files LOW.
  613.            \DOS\           ; Truncate sub-directory DOS, and put it
  614.                            ; next to the FAT.
  615.            [ENDTRUNCATE]
  616.            \COMMAND.COM    ; COMMAND.COM will be placed after \\DOS.
  617.            [FREE 500]      ; leave some room
  618.            ;
  619.            [HIGH]          ; set move files HIGH.
  620.            \AUTOEXEC.BAT   ; As this file is used only once, on
  621.                            ; reboot, we can move it away from the
  622.                            ; FAT.
  623.            \CONFIG.SYS     ; another seldom used file.
  624.            \ORDER.DOG      ; This file will be place just in front
  625.                            ; of CONFIG.SYS
  626.  
  627.         ________________________________________________________________
  628.  
  629.              FREE command.
  630.  
  631.         FORCE - tells Disk OrGanizer not to move the files that  follow.
  632.              If  you are going to FORCE file you should do it before you
  633.              place files LOW or HIGH.
  634.  
  635.         FLOAT - tells Disk OrGanizer to ignore the  files  that  follow.
  636.              This  is  used  if you wish to TRUNCATE a sub-directory but
  637.              don't want to put it LOW, HIGH or FORCE.  NOTE:  in  future
  638.              releases  this may be used this to allow SYSTEM files to be
  639.              moved.
  640.  
  641.         These  commands  control  whether  named  directories  will   be
  642.         truncated.
  643.  
  644.         TRUNCATE ALL - will truncate all directories on the disk.
  645.  
  646.         TRUNCATE -    sub-directories   named   between   TRUNCATE   and
  647.              ENDTRUNCATE will have there size changed so that they  will
  648.              use as little space as possible.
  649.  
  650.  
  651.  
  652.  
  653.      Disk OrGanizer                                                       9
  654.  
  655.      2. Using Disk OrGanizer
  656.      ----------------------------------------------------------------------
  657.      2.4.3. Order file Commands
  658.  
  659.  
  660.         ENDTRUNCATE - see TRUNCATE above.
  661.  
  662.         System directories and directories that have already been placed
  663.         LOW, HIGH, or FORCED, will not be truncated.
  664.  
  665.         The following command will force clusters to be left free.
  666.  
  667.         FREE nnnn - tells  Disk  OrGanizer  to  leave  nnnn  (a  number)
  668.              clusters  of  free  space  after the last file named in the
  669.              order file, if files are being placed LOW,  or  before  the
  670.              file if files are being placed HIGH. Disk OrGanizer ignores
  671.              this command if there isn't enough free disk  space.    The
  672.              nnnn  may  be replaced with an asterisk (*) if you want all
  673.              available free clusters in a location.
  674.  
  675.         2.4.4. File identifiers
  676.  
  677.         A file identifier is a string that starts with a backslash  (\),
  678.         has  zero  or  more sub-directory names separated by backslashes
  679.         (the Path), and ends with a filename or  sub-directory  name.  A
  680.         file identifier ending with a sub-directory name can be followed
  681.         by an optional backslash.
  682.  
  683.         It is important to understand that a  sub-directory  is  a  file
  684.         with  a  special  format  and  that  Disk  OrGanizer treats sub-
  685.         directories just like files in the orderfile  except  that  sub-
  686.         directories can be TRUNCATED.
  687.  
  688.         You  must  always  include  the  full  path  of  a  file or sub-
  689.         directory.
  690.  
  691.         Wildcards may be used in filenames.  But please  note  that  in-
  692.         cluding  a  large  number of files in the ORDER file can greatly
  693.         increase the amount of time it take Disk OrGanizer to organize a
  694.         disk.
  695.  
  696.         2.4.5. Comments
  697.  
  698.         A  comment  starts  with  a  semicolon  and ends with a carriage
  699.         return.
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.      Disk OrGanizer                                                      10
  715.  
  716.      3. Licensing and support
  717.      ----------------------------------------------------------------------
  718.      3.1. Copyright/License/Warranty
  719.  
  720.  
  721.         3.1. Copyright/License/Warranty
  722.  
  723.         This document and the program files DOG.EXE ("the software") are
  724.         copyrighted  by the author.  The copyright owner hereby licenses
  725.         you to use the software given these restrictions:
  726.  
  727.          o  the program shall be supplied in  its  original,  unmodified
  728.             form, which includes this documentation;
  729.  
  730.          o  for-profit use without a license is prohibited;
  731.  
  732.          o  the  program  may  not be included - or bundled - with other
  733.             goods or services.  Exceptions may be granted  upon  written
  734.             request only.
  735.  
  736.          o  no fee is charged; an exception is granted to not for profit
  737.             user's groups, which are permitted to  charge  a  small  fee
  738.             (not  to  exceed  $5)  for materials, handling, postage, and
  739.             general overhead.  No other  organization  is  permitted  to
  740.             charge any amount for distribution of copies of the software
  741.             or documentation, or to include copies of  the  software  or
  742.             documentation with sales of their own products.
  743.  
  744.         There  is  no warranty of any kind.  The copyright owner may not
  745.         be held liable for any damages, including any  lost  profits  or
  746.         other  incidental or consequential damages arising out of or in-
  747.         ability to use the software.  By using the software,  you  agree
  748.         to this.
  749.  
  750.         3.2. Licensing
  751.  
  752.         No  license is required to run Disk OrGanizer on a computer that
  753.         is not used for business.
  754.  
  755.         The fee for a license depends on the estimated number of  copies
  756.         of  the program that you will use.  For local area networks, one
  757.         copy must be licensed for each computer that will be  using  the
  758.         program on the network.
  759.  
  760.         A license is not transferable.
  761.  
  762.                      Quantity     Price  Update
  763.                      ========     ==.==   ==.==
  764.                             1     30.00    6.00  each
  765.  
  766.                        2 to 9     25.00    5.00
  767.                      10 to 49     20.00    4.00
  768.                      50 to 99     15.00    3.00
  769.                    100 to 199     10.00    2.00
  770.  
  771.         Unlimited at one site  $2000.00  400.00
  772.              Additional sites   1000.00  200.00  unlimited at each site
  773.  
  774.  
  775.      Disk OrGanizer                                                      11
  776.  
  777.      3. Licensing and support
  778.      ----------------------------------------------------------------------
  779.      3.2. Licensing
  780.  
  781.  
  782.  
  783.         The  price  to update to a new version applies only to the quan-
  784.         tity previously registered.
  785.  
  786.         Regardless of the quantity purchased you will receive  only  one
  787.         disk  and  one  printed manual. Additional manuals are available
  788.         for $6.00 each. You may make as many copies as are licensed  and
  789.         one archive copy.
  790.  
  791.         Orders of $50 or less must be prepaid. Orders over $50 - NET 30.
  792.  
  793.              Soft GAM's Software    SSN# 559-29-3621
  794.              P. O. Box 1311         (707)961-1632
  795.              Mendocino, CA  95460
  796.  
  797.  
  798.         3.3. Technical Support
  799.  
  800.         Technical  support  is  available  to  registered  and  licensed
  801.     users.   Limited  support  is  also  available  to  help  you to
  802.         get  Disk  OrGanizer  to  operate on a computer, so that you can
  803.         evaluate it.
  804.  
  805.              CompuServe: PPN# 73210,3374
  806.  
  807.              the Bit Boutique BBS 707-778-8944, 2400 baud
  808.              Leave E-Mail to ALLEN MORRIS
  809.  
  810.              Mail : Soft GAM's Software, Box 1311, Mendocino, CA 95460
  811.  
  812.              Phone: (707)961-1632 (10 to 6 Pacific Time)
  813.  
  814.         3.4. ASP Ombudsman Information
  815.  
  816.         Disk OrGanizer is produced by a member  of  the  Association  of
  817.         Shareware  Professionals (ASP).  ASP wants to make sure that the
  818.         shareware principle works for you.  If you are unable to resolve
  819.         a shareware-related problem with an ASP member by contacting the
  820.         member directly, ASP may be able to help. The ASP ombudsman  can
  821.         help  you  resolve  a dispute or problem with an ASP member, but
  822.         does  not  provide  technical  support  for  members'  products.
  823.         Please write to the ASP Ombudsman at:
  824.  
  825.              ASP Ombudsman
  826.              545 Grover Road
  827.              Muskegon, MI 49442
  828.  
  829.         or send a CompuServe message via Easyplex electronic mail to the
  830.         ASP Ombudsman, CompuServe ID number 70475,1071.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.      Disk OrGanizer                                                      12
  837.  
  838.      4. Error messages
  839.      ----------------------------------------------------------------------
  840.  
  841.  
  842.         The  number  in  parentheses  is the ERRORLEVEL returned by Disk
  843.         OrGanizer. If the error code is 100 or above, data may have been
  844.         lost on the disk.
  845.  
  846.         No Errors (0)
  847.              You are a happy camper.
  848.  
  849.         Terminated by user. (1)
  850.              The disk may still need to be organized.
  851.  
  852.         Illegal I/O redirection. (2)
  853.              Do not redirect output to the drive being organized.
  854.  
  855.         Order file is a device. (3)
  856.              The order file can't be read from a device, use a file.
  857.  
  858.         File not found. (4)
  859.              Check the filename you entered.
  860.  
  861.         Could not read/understand disk information. (5)
  862.              Please write or call and we can try to solve this problem.
  863.  
  864.         Error in order file. (6)
  865.              Fix  or  remove  bad  commands  or filenames from the order
  866.              file.
  867.  
  868.         Error on the command line. (7)
  869.              Check the syntax on the command line.
  870.  
  871.         Network drive. (8)
  872.              Reboot your computer without the network or  don't  publish
  873.              the drive you want to organize.
  874.  
  875.         Invalid drive. (9)
  876.              Specify a valid drive.
  877.  
  878.         Could not find directory for open file. (10)
  879.              Remove  background  programs or reboot the computer and try
  880.              again.
  881.  
  882.         Out of memory. (11)
  883.              Remove TSR programs, increase EMS memory  or  set  the  en-
  884.              vironment  variable  TEMP  or DOGTEMP to a path that can be
  885.              used for temporary storage.
  886.  
  887.         Error reading FAT. (I/O) (12)
  888.              Back up and reformat the disk or mark bad clusters bad.
  889.  
  890.         Possible NON DOS disk. (13)
  891.              The disk is an unknown type or the second FAT is  bad.  Run
  892.              chkdsk.    If  you  are still unable to run Disk OrGanizer,
  893.  
  894.  
  895.  
  896.  
  897.      Disk OrGanizer                                                      13
  898.  
  899.      4. Error messages
  900.      ----------------------------------------------------------------------
  901.  
  902.  
  903.              Please call or write.
  904.  
  905.         Bad cluster in FAT. (14)
  906.              Run chkdsk.  If you are still unable to run Disk OrGanizer,
  907.              Please call or write.
  908.  
  909.         Error reading Directory (I/O) (15)
  910.              Back up and reformat the disk or mark bad clusters bad.
  911.  
  912.         Directory is corrupt. (16)
  913.              Run CHKDSK to repair the disk.
  914.  
  915.         Lost clusters found. (17)
  916.              Run CHKDSK to repair the disk or run Disk OrGanizer without
  917.              the BATCH or TEST switches set.
  918.  
  919.         You must have at least one free cluster. (18)
  920.              You should delete at least one file.
  921.  
  922.         Too many total files. (19)
  923.              Delete files from the disk until there are less that 32,752
  924.              files.
  925.  
  926.         Free clusters in FAT doesn't match DOS (21)
  927.              Remove any background programs that write to the disk.
  928.  
  929.         Could not CHDIR to root. (22)
  930.              I do not know what could cause this error.
  931.  
  932.         Too many fragmented files, use DIR mode. (23)
  933.              Use DIRECTORY, or DATE mode.  Once the number of fragmented
  934.              files  is  reduced  you  use  the  mode that generated this
  935.              error.
  936.  
  937.         No mode was given. (24)
  938.              You must supply a mode on the command line or in the  order
  939.              file.
  940.  
  941.         Incorrect DOS version. (42)
  942.              Reboot with DOS version 2 or greater.
  943.  
  944.         STDIN or STDERR redirected. (43)
  945.              Do not redirect the input or error output.
  946.  
  947.         Too many arguments. (44)
  948.              Remove some commands from the command line.
  949.  
  950.         Critical errors. (45)
  951.              Fix the problem that caused the critical error.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.      Disk OrGanizer                                                      14
  959.  
  960.      4. Error messages
  961.      ----------------------------------------------------------------------
  962.  
  963.  
  964.         INTERNAL ERROR @'code'. (90)
  965.              Please call and tell me the code that you received.
  966.  
  967.         I/O error moving clusters. Disk is OK. (99)
  968.              An I/O error was detected.  You  should  run  a  disk  test
  969.              program  on  the  disk or back up the disk, reformat it and
  970.              restore the data.  No data was lost and the disk is in good
  971.              repair.
  972.  
  973.         I/O error moving clusters. Data may have been lost. (100)
  974.              An  I/O error was detected. You should run a disk test pro-
  975.              gram on the disk or back up the disk, reformat it  and  re-
  976.              store the data.  There may be errors on the disk.
  977.  
  978.         I/O error Packing (101)
  979.              There  was  an  error Packing a directory. You should run a
  980.              disk test program on the disk or back up the disk, reformat
  981.              it and restore the data.  There may be errors on the disk.
  982.  
  983.         Critical errors. (102)
  984.              Fix  the  problem that caused the critical error. There may
  985.              be errors on the disk.
  986.  
  987.         INTERNAL ERROR @'code'. (200)
  988.              Please call and tell me the code that you got. There may be
  989.              errors on the disk.
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.      Disk OrGanizer                                                      15
  1020.  
  1021.      5. Glossary
  1022.      ----------------------------------------------------------------------
  1023.  
  1024.  
  1025.  
  1026.         CHKDSK - A  program  that  came  with  DOS.  Its  full  name  is
  1027.         CHKDSK.COM. See your DOS manual for more information.
  1028.  
  1029.         Cluster - DOS stores data in cluster units. Clusters are made of
  1030.         one or more sectors.
  1031.  
  1032.         FAT - The File Allocation Table.
  1033.  
  1034.         File Allocation Table - This along with the directories tell DOS
  1035.         where to find a file on the disk.
  1036.  
  1037.         Hidden  file  -  A  file with the hidden attribute bit set. Disk
  1038.         OrGanizer will move these files.
  1039.  
  1040.         Hidden directory - A directory with  the  hidden  attribute  bit
  1041.         set. Disk OrGanizer will move these directories.
  1042.  
  1043.         Lost clusters - Clusters that are mark in the FAT as being used,
  1044.         but have no directory entry that points to them.
  1045.  
  1046.         Null file - A file with no data in it.
  1047.  
  1048.         Sector - The smallest unit that data can be stored on a disk.
  1049.  
  1050.         System file - A file with the system  attribute  bit  set.  Disk
  1051.         OrGanizer will not move these files.
  1052.  
  1053.         System  directory  -  A  directory with the system attribute bit
  1054.         set.  Disk OrGanizer will not move these directories.
  1055.  
  1056.         User file - A file that does not have the system or  hidden  at-
  1057.         tribute bits set. Disk OrGanizer will move these files.
  1058.  
  1059.         User  directory  -  A directory that does not have the system or
  1060.         hidden attribute  bits  set.  Disk  OrGanizer  will  move  these
  1061.         directories.
  1062.  
  1063.         Volume label - A special file that tells DOS the name of a disk.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.      Disk OrGanizer                                                      16
  1081.  
  1082.      6. Index
  1083.      ----------------------------------------------------------------------
  1084.  
  1085.  
  1086.         Aborting from DOG  4           Order file Commands (Cont.)
  1087.         ALLDIRECTORIES  8                 ENDTRUNCATE  9
  1088.         AUTO  7                           FLOAT  9
  1089.         BATCH  6                          FORCE  9
  1090.         CHKDSK  3, 16                     FREE nnnn  10
  1091.         Cluster  16                       HIGH  8
  1092.         Command line commands             LOW  8
  1093.            AUTO  7                        PATH  8
  1094.            TRUNCATE  7                    TRUNCATE ALL  9
  1095.         COMSPEC  7, 8                     TRUNCATE  9
  1096.         Copy protected programs  3     orderfile  6
  1097.         Copyright  11                  PACKED  6
  1098.         CRC  6                         PATH  7, 8
  1099.         current drive  6               QUICK  5
  1100.         DATE  5                        Sector  16
  1101.         DEFRAG  5                      Switches
  1102.         DIRECTORY  5                      BATCH  6
  1103.         drive specifier  6                CRC  6
  1104.         ENDTRUNCATE  9                    NOVERIFY  6
  1105.         environment                    System directory  16
  1106.            COMSPEC  7                  System file  16
  1107.            PATH  7                     Technical Support  12
  1108.         FAST  5                        TRUNCATE ALL  9
  1109.         FASTOPEN  2                    TRUNCATE  7, 9
  1110.         FAT  16                        User directory  16
  1111.         File Allocation Table  16      User file  16
  1112.         FILL  5                        Volume label  16
  1113.         FLOAT  9
  1114.         FORCE  9
  1115.         FRAGMENTED  6
  1116.         FREE nnnn  10
  1117.         Hidden directory  16
  1118.         Hidden file  16
  1119.         HIGH  8
  1120.         License  1, 11
  1121.         Lost clusters  16
  1122.         LOW  8
  1123.         Modes
  1124.            DATE  5
  1125.            DEFRAG  5
  1126.            DIRECTORY  5
  1127.            FAST  5
  1128.            FILL  5
  1129.            FRAGMENTED  6
  1130.            PACKED  6
  1131.            QUICK  5
  1132.         NOVERIFY  6
  1133.         NUL device  7
  1134.         Null file  16
  1135.         Open files  2
  1136.         Order file Commands
  1137.            ALLDIRECTORIES  8
  1138.            COMSPEC  8
  1139.  
  1140.  
  1141.      Disk OrGanizer                                                      17
  1142.  
  1143.